Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRInstallInterceptProc

You can use the QTVRInstallInterceptProc function to install or remove an intercept procedure for a QuickTime VR Manager function.

OSErr QTVRInstallInterceptProc (
                     QTVRInstanceqtvr,
                     QTVRProcSelectorselector,
                     QTVRInterceptUPPinterceptProc,
                     SInt32refCon,
                     UInt32 flags);
qtvr
An instance of a QuickTime VR movie.
selector
A selector that indicates which QuickTime VR function to intercept. See "Intercept Selectors" for a description of the available intercept selectors.
interceptProc
A universal procedure pointer for an intercept procedure. See "QuickTime VR Intercept Procedure" for information about intercept procedures. Set this parameter to nil to remove a previously installed intercept procedure.
refCon
A reference constant. This value is passed to the specified intercept routine.
flags
Unused. Set this parameter to 0.
function result
A result code.

DESCRIPTION

The QTVRInstallInterceptProc function installs the procedure specified by the interceptProc parameter as an intercept procedure for the QuickTime VR function specified by the selector parameter for the QuickTime VR movie specified by the qtvr parameter. Your intercept procedure is called whenever QuickTime VR is about to execute the function it's intercepting. Your procedure can simply replace the intercepted function, or it can call through to the intercepted function (either by calling the QTVRCallInterceptedProc function or by returning the value false in its cancel parameter).

SEE ALSO

Listing 2-8 illustrates the use of QTVRInstallInterceptProc .


© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |